home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / cisecol.arc / CISEINST.DOC < prev    next >
Encoding:
Text File  |  1985-12-16  |  15.1 KB  |  416 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                          INSTALLATION AND CONFIGURATION
  13.                                  GUIDE FOR THE
  14.                       CENTER INFORMATION SYSTEM EXECUTIVE
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                                   Prepared by
  37.  
  38.                          Computer Sciences Corporation
  39.                           Applied Technology Division
  40.                                  Houston, Texas
  41.  
  42.                               Contract NAS 9-15700
  43.  
  44.                                       For
  45.  
  46.                         DATA PROCESSING SYSTEMS DIVISION
  47.  
  48.                                   October 1985
  49.  
  50.  
  51.  
  52.                                                                   CSC-2217
  53.  
  54.  
  55.  
  56.                                TABLE OF CONTENTS
  57.  
  58.       Section                                                         Page
  59.  
  60.       1.0  INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . 1
  61.  
  62.         1.1  PURPOSE AND SCOPE  . . . . . . . . . . . . . . . . . . . . 1
  63.  
  64.         1.2  THE CAT 0/0A USER WORK STATION
  65.              CENTER INFORMATION SYSTEM EXECUTIVE (CISE) . . . . . . . . 1
  66.  
  67.       2.0  FILES RELATED TO THE CISE  . . . . . . . . . . . . . . . . . 1
  68.  
  69.         2.1  FILES THAT SHOULD BE INSTALLED
  70.              WITH THE CISE  . . . . . . . . . . . . . . . . . . . . . . 1
  71.  
  72.         2.2  STARTUP LOGO FILES . . . . . . . . . . . . . . . . . . . . 2
  73.  
  74.           2.2.1  Logo.bas . . . . . . . . . . . . . . . . . . . . . . . 2
  75.  
  76.           2.2.2  Scrn.dat . . . . . . . . . . . . . . . . . . . . . . . 2
  77.  
  78.         2.3  FILES NECESSARY FOR THE 
  79.              OPERATION OF THE CISE. . . . . . . . . . . . . . . . . . . 2
  80.  
  81.           2.3.1  Mmenu.exe  . . . . . . . . . . . . . . . . . . . . . . 2
  82.  
  83.           2.3.2  Mmenu.scr  . . . . . . . . . . . . . . . . . . . . . . 2
  84.  
  85.           2.3.3  Mmenu.hlp  . . . . . . . . . . . . . . . . . . . . . . 3
  86.  
  87.           2.3.4  Batfmgr.bat  . . . . . . . . . . . . . . . . . . . . . 3
  88.  
  89.           2.3.5  Config.dat . . . . . . . . . . . . . . . . . . . . . . 3
  90.  
  91.         2.4  AUTOMATIC EXECUTION AT POWER UP  . . . . . . . . . . . . . 6
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                                        ii
  104.  
  105.  
  106.  
  107.       1.0  INTRODUCTION
  108.  
  109.       1.1  PURPOSE AND SCOPE
  110.  
  111.       This  document  describes the installation and configuration of  the 
  112.       Center Information System Executive (CISE).   The CISE is a  program 
  113.       that allows users to execute any application program at the press of 
  114.       a  function  key.   The CISE is flexible enough to configure to  any 
  115.       type  of Personal Computer application,  has many useful  functions, 
  116.       and is simple to use.
  117.  
  118.       See  the  "USERS GUIDE FOR THE CENTER INFORMATION SYSTEM  EXECUTIVE" 
  119.       (CSC-2108)  for  an explanation of the program,  its  use,  and  its 
  120.       features.
  121.  
  122.       1.2  THE CAT 0/0A USER WORK STATION CENTER INFORMATION
  123.            SYSTEM EXECUTIVE
  124.  
  125.       The  CISE  is  easily configured to any IBM  PC  compatible  machine 
  126.       running the MS-DOS operating system.  Furthermore, its configuration 
  127.       is  not  dependent on the specific machine  type.   Any  program  or 
  128.       series  of  programs  that can be initiated via the execution  of  a 
  129.       "batch"  file  can  be assigned to any of the  twenty  function  key 
  130.       definitions.
  131.  
  132.       When  a  programmed function key is pressed,  the  CISE  dynamically 
  133.       builds a batch file to execute the command or statements assigned to 
  134.       that  function  key.   This  batch file is  then  executed.   If  so 
  135.       directed,  the  batch file will contain statements that will execute 
  136.       the CISE again when the "execution" of a function key is complete.
  137.  
  138.       2.0  CISE FILES
  139.  
  140.       2.1  REQUIRED FILES
  141.  
  142.       The  files  that  should  be installed with the CISE  are  named  as 
  143.       follows:
  144.  
  145.         LOGO.BAS  (optional)
  146.         SCRN.DAT  (optional)
  147.         MENU.BAT
  148.         MMENU.EXE
  149.         MMENU.SCR
  150.         MMENU.HLP
  151.         BATFMGR.BAT
  152.         CONFIG.DAT
  153.  
  154.  
  155.  
  156.  
  157.       Each  of these files should be installed in the directory from where 
  158.       the CISE will be executed and reside.   In most cases,  this will be 
  159.       the root directory.
  160.  
  161.  
  162.       2.2  STARTUP LOGO FILES
  163.  
  164.       2.2.1  Logo.bas
  165.  
  166.       This  is  a BASIC program that will display the  startup  logo.   To 
  167.       execute  LOGO.BAS,  the  BASIC  interpreter  must  be  in  the  same 
  168.       directory, or accessible via the DOS "path".
  169.  
  170.       This file is not necessary for operation of the CISE.   It is simply 
  171.       the  "startup  logo"  that users will see each time the  machine  is 
  172.       reset, or powered on.
  173.  
  174.       If the startup logo is desired,  there should be a line in the  file 
  175.       AUTOEXEC.BAT that reads:
  176.         BASICA LOGO
  177.  
  178.       2.2.2  Scrn.dat
  179.  
  180.       This  is the name of the "logo" screen.   It is simply a  core-image 
  181.       file  that is loaded into the video memory mapped RAM.
  182.  
  183.       This  file  is mandatory if the startup logo  is  desired.  It  must 
  184.       reside  in the same directory as LOGO.BAS.   If it cannot be  found, 
  185.       an error message will be displayed.
  186.  
  187.       2.3  FILES NECESSARY FOR OPERATION OF THE CISE
  188.  
  189.       2.3.1  Mmenu.exe
  190.  
  191.       This  is the name of the actual program.   It is a DOS  "executable" 
  192.       file,  but  should  not  be executed  directly.   The  execution  of 
  193.       MMENU.EXE  will  be  initiated  by a statement  in  the  batch  file 
  194.       MENU.BAT.
  195.  
  196.       When  a  configured function key is pressed (at the CISE  main  menu 
  197.       screen)  this  program will write a new batch  file  "MENU.BAT"  and 
  198.       exit.   The  batch file MENU.BAT will continue execution (as it  was 
  199.       responsible  for  executing "MMENU.EXE") with new statements in  it.  
  200.       These new statements were written by the program "MMENU.EXE".   They 
  201.       are  the  DOS  commands  or statements that  were  assigned  to  the 
  202.       function  key pressed (and usually some lines that  will  re-execute 
  203.       the batch file MENU.BAT).
  204.  
  205.  
  206.  
  207.  
  208.       2.3.2  Mmenu.scr
  209.  
  210.       This is the name of the main menu screen.  It is simply a core-image 
  211.       file  that is loaded into the video memory mapped RAM.   It contains 
  212.       everything on the main menu screen except:  the calendar, date, day, 
  213.       time, and the function key definitions.  Through the use of a simple 
  214.       BASIC program, this screen may be customized.
  215.  
  216.       This file is mandatory for the operation of the CISE.   If it is not 
  217.       found,  an error message will be displayed.
  218.  
  219.       2.3.3  Mmenu.hlp
  220.  
  221.       This  is  the  name of the file containing the  CISE  help  screens.  
  222.       The  CISE  help  screens are called up any time the user  selects  a 
  223.       HELP function key.   This file contains help screens for:  the  CISE 
  224.       main menu, the scheduler/notepad, and the calculator.
  225.  
  226.       If this file is not present, the CISE will function normally, unless 
  227.       a  help key is pressed,  then the user will be informed that help is 
  228.       not available.
  229.  
  230.       2.3.4  Batfmgr.bat
  231.  
  232.       This is a batch file that starts the execution of a file manager.  A 
  233.       batch  file is used here because some file management programs  will 
  234.       only  function in the directory that they reside in.   If  the  File 
  235.       Manager option is chosen, the user is prompted for a directory name.  
  236.       BATFMGR.BAT  will  then  copy that file manager to  the  destination 
  237.       directory,  execute it,  and remove it from there.  If the directory 
  238.       chosen  is  the one that the file manager resides  in,  then  it  is 
  239.       simply executed.
  240.  
  241.       BATFMGR.BAT must be configured for the file management program used, 
  242.       and the directory that it resides in.
  243.  
  244.       If the file management program being used has the ability to work in 
  245.       any sub-directory, this batch file should be removed, and line 22 of 
  246.       the  config  file (see section 2.3.5) should have  the  instructions 
  247.       necessary to execute the file manager, and return to the CISE.
  248.  
  249.       If  line number 22 of the config file is blank nothing  will  happen 
  250.       when the File Manager option is chosen.
  251.  
  252.       2.3.5  Config.dat
  253.  
  254.       This  CISE file contains the list of programs or utilities that  may 
  255.       be changed by the user.   It includes: the function key definitions, 
  256.       how  to re-start the CISE,  how to start the file manager,  the text 
  257.  
  258.  
  259.  
  260.  
  261.       that  appears  at  the lower right of the CISE  main  menu,  and  an 
  262.       indicator that will turn on or off a bell that rings if a wrong  key 
  263.       is pressed during execution of the CISE.
  264.       This  file  must  have exactly 24 lines in it,  four  of  which  are 
  265.       special; the rest are function key definitions.
  266.  
  267.       The special lines are as follows:
  268.  
  269.       Line  1 - this line contains instructions that are used to start the 
  270.       CISE again after the execution of programs assigned to the  function 
  271.       keys.   Its  format  is  identical to the  function  key  assignment 
  272.       entries (lines 2 thru 21).
  273.  
  274.         For  example,  if the CISE resides in the root directory of  drive 
  275.         C:, the first line might read as follows:
  276.  
  277.           C:;CD \;MENU
  278.  
  279.         This line will: change the default drive back to C: (it could have 
  280.         been changed by an application), change the default directory back 
  281.         to the "root" (in case it was changed), and execute the batch file 
  282.         MENU.BAT again.
  283.  
  284.       Line  22 - this line contains the name of the program or batch  file 
  285.         that  will  be executed when the user selects the  "File  Manager" 
  286.         option.   The format of this entry is identical to those used  for 
  287.         the function key assignments.
  288.  
  289.       Line  23  - this line contains a string of text that will appear  on 
  290.         the CISE main menu at the lower right corner.   It is not used  by 
  291.         the CISE.   This line may be used to display:  configuration type, 
  292.         machine type, installation name, or any other text string that the 
  293.         user desires.
  294.  
  295.       Line  24 - this line must contain either "BEEP OFF",  or "BEEP  ON".  
  296.         If this line reads "BEEP ON",  the CISE will cause an audible tone 
  297.         if  any  "unexpected"  key or undefined function  key  is  pressed 
  298.         during the operation of the CISE.
  299.  
  300.       The  lines 2 thru 21 of CONFIG.DAT are used to assign function keys.  
  301.       There  is  one line (entry) per function  key.  These  function  key 
  302.       assignment  lines may be up to 255 characters long.  If one of these 
  303.       lines are left blank (there must be exactly 24 lines in CONFIG.DAT), 
  304.       nothing will appear on the screen next to the corresponding function 
  305.       key name, and no action will occur if that key is pressed.
  306.  
  307.  
  308.  
  309.  
  310.       The function key assignment format is as follows:
  311.       The  text  up until (but not including) the first semi-colon (;)  is 
  312.       the  text  that  will  appear on the  screen  corresponding  to  the 
  313.       function  key  for  this entry.   It should not be  longer  than  23 
  314.       characters.
  315.  
  316.       The  rest of the entry contains DOS command(s),  or program  name(s) 
  317.       (separated  by semi-colons) that will be executed when the  function 
  318.       key corresponding to entry is pressed.
  319.  
  320.       For example, if line two (2) of CONFIG.DAT reads is:
  321.  
  322.         WORDSTAR;CD \WORDSTAR;WS
  323.  
  324.       The text "WORDSTAR" will appear next to "F1:" on the CISE main menu.  
  325.       When function key 1 (F1) is pressed,  the following commands will be 
  326.       executed:
  327.  
  328.         CD \WORDSTAR
  329.         WS
  330.  
  331.       The  first  command  will change the current DOS directory  to   one  
  332.       called   "\WORDSTAR".  The  second command will execute the  program 
  333.       "WS".
  334.  
  335.  
  336.       When the user exits from WORDSTAR, the commands/statements on line 1 
  337.       of  CONFIG.DAT  will be executed in a  similar  manner.   This  will 
  338.       normally cause the CISE to be re-started.
  339.  
  340.       There  are some special characters that can be used in lines 2  thru 
  341.       21.  These are:
  342.  
  343.       A)  An asterisk (*).  This will cause the function key definition to 
  344.           not   include  the  statements/commands  found  on  line  1   of 
  345.           CONFIG.DAT.
  346.  
  347.           For example, if line two (2) of CONFIG.DAT reads:
  348.  
  349.             WORDSTAR;CD \WORDSTAR;WS;*
  350.  
  351.           Wordstar  will execute,  just as in the above example;  however, 
  352.           when its execution is complete,  the statements/commands on line 
  353.           1 of CONFIG.DAT will NOT be executed.   In other word, after the 
  354.           execution of "WS", the user will simply go to the DOS prompt.
  355.  
  356.  
  357.  
  358.  
  359.           This is useful in two cases:
  360.  
  361.           1)  For an option such as "Exit to DOS".  If the asterisk (*) is 
  362.               not used, the function key assigned to "exit" will not exit, 
  363.               it will return to the CISE.
  364.               For example, if line two (2) of CONFIG.DAT reads:
  365.                   Exit to DOS;CLS;*
  366.               when  function  key 1 (F1) is pressed,  the screen  will  be 
  367.               cleared, and the user will be left at the DOS prompt (C>).
  368.  
  369.           2)  For  an  option that executes a batch file.   If any of  the 
  370.               function  key  assignments  execute  a  batch  file  (rarely 
  371.               necessary),  then  the batch file should contain  statements 
  372.               necessary to return to the CISE, if desired.
  373.  
  374.       B) A pound-sign (#).   A pound sign after a command,  statement,  or 
  375.          application  name  will  cause  the  user  to  be  prompted   for 
  376.          "Parameters/Options" that go with that statement.
  377.          For example:
  378.          For example, if line two (2) of CONFIG.DAT reads is:
  379.            EDLIN;EDLIN #
  380.  
  381.          When  Function key 1 (F1) is pressed,  the user will be  prompted 
  382.          for "Parameters/Options".   Any text typed here will replace  the 
  383.          pound   sign.    If  in  the  above  example,   the  user  enters 
  384.          AUTOEXEC.BAT, the command executed will be:
  385.            EDLIN AUTOEXEC.BAT
  386.  
  387.       NOTE:  There is one DOS command that makes use of a semi-colon.  The 
  388.       "PATH" command used to set the DOS path uses semi-colons to separate 
  389.       directory names.   This command should not be used in CONFIG.DAT, as 
  390.       its use may cause confusion to the CISE.
  391.  
  392.       2.4 AUTOMATIC EXECUTION AT POWER UP
  393.  
  394.       A  batch  file  AUTOEXEC.BAT (if found) is executed  on  all  MS-DOS 
  395.       machines.   The  CISE (and its logo) may be executed on machine boot 
  396.       up by making an entry in AUTOEXEC.BAT instructing this to happen.
  397.  
  398.       If  the user desires the startup logo,  the second-to last  line  in 
  399.       autoexec.bat should be:
  400.  
  401.         BASICA LOGO
  402.  
  403.       (For this,  BASICA should be in the current directory, or in the DOS 
  404.       path.  LOGO.BAS should be in the current directory.)
  405.  
  406.  
  407.  
  408.  
  409.       To start the CISE, the last line in AUTOEXEC.BAT should be:
  410.  
  411.         MENU
  412.  
  413.       This  command will cause execution of MENU.BAT which  will  initiate 
  414.       execution of the CISE.  If this is the last line in AUTOEXEC.BAT the 
  415.       CISE will execute every time the machine is booted.
  416.